---
title: 故障排除
description: Learn how to troubleshoot issues with the OpenAI Agents SDK.
---

## 支持的环境

OpenAI Agents SDK 支持以下服务器环境：

- Node.js 22+
- Deno 2.35+
- Bun 1.2.5+

### 有限支持

- **Cloudflare Workers**：Agents SDK 可用于 Cloudflare Workers，但目前存在一些限制：
  - SDK 目前需要启用 `nodejs_compat`
  - 需要在请求结束时手动刷新追踪数据。参见[追踪](/openai-agents-js/zh/guides/tracing#export-loop-lifecycle)了解详情。
  - 由于 Cloudflare Workers 对 `AsyncLocalStorage` 的支持有限，某些追踪可能不够准确
  - 出站 WebSocket 连接必须使用基于 fetch 的升级方式（不能使用全局 `WebSocket` 构造函数）。对于实时功能，请在 `@openai/agents-extensions` 中使用 Cloudflare 传输（`CloudflareRealtimeTransportLayer`）。
- **浏览器**：
  - 浏览器当前不支持追踪
- **v8 isolates**：
  - 如果使用带有合适浏览器 polyfill 的打包工具，您应当可以为 v8 isolates 打包 SDK，但追踪将无法工作
  - v8 isolates 尚未经过广泛测试

## 调试日志

如果您在使用 SDK 时遇到问题，可以启用调试日志以获取更多运行信息。

通过将环境变量 `DEBUG` 设置为 `openai-agents:*` 来启用调试日志。

```bash
DEBUG=openai-agents:*
```

或者，您也可以仅针对 SDK 的特定部分开启调试：

- `openai-agents:core` — SDK 的主要执行逻辑
- `openai-agents:openai` — OpenAI API 调用
- `openai-agents:realtime` — 实时智能体组件
